Magic Desk (tm) Version 3.0 User's Guide Copyright 1991-1993 Virtual Magic Software All Rights Reserved Virtual Magic Software P.O. Box 12264 Huntsville, Alabama 35815-0264 CompuServe: 70304,2045 Prodigy: CJKH33A Internet: 70304.2045@compuserve.com WARRANTY AND LICENSE...........................................2 INTRODUCTION...................................................2 SYSTEM REQUIREMENTS............................................3 INSTALLING MAGIC DESK..........................................3 STARTING MAGIC DESK............................................3 MOVING AROUND IN MAGIC DESK....................................4 ADDING A PROGRAM OR PAGE.......................................6 REMOVING A PROGRAM OR PAGE.....................................9 VIEWING/MODIFYING A PROGRAM OR PAGE............................9 SETTING CONFIGURATION OPTIONS.................................10 SETTING COLOR OPTIONS.........................................12 SETTING SCREEN BLANKER OPTIONS................................12 RUNNING PROGRAMS FROM MAGIC DESK..............................13 ARRANGING BUTTONS.............................................14 PAINTER.......................................................15 TIPS AND TECHNIQUES...........................................17 COMPATIBILITY WITH EARLIER VERSIONS...........................20 ==================== WARRANTY AND LICENSE ==================== THIS PROGRAM IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PROGRAM. This is an unregistered evaluation version of Magic Desk. You are licensed to use this version for a reasonable evaluation period, up to 30 days. If after the evaluation period you wish to continue using Magic Desk, you must submit the required registration fee. There are several advantages to becoming a registered user. Please see the REGISTER.TXT file for complete registration details. ============ INTRODUCTION ============ Magic Desk is a graphical DOS menuing system that lets you easily run all of your programs without having to remember cryptic DOS commands. Magic Desk is unique because it has all the advanced features found in menuing systems designed for adults, yet it is so safe and simple that even young children can use it. It's incredibly easy to set up your programs to run from Magic Desk. Simply enter the program title, where the program is on disk, and the name of the icon you want to use to represent the program. File pick-lists make your job even easier. Magic Desk will create a large 3-D button with the icon you've chosen. From then on, you can start the program simply by selecting the button with the mouse or keyboard. When your program is finished, Magic Desk automatically reappears so you can select another program. It couldn't be any easier! You can use readily available Microsoft Windows icons, or you can design your own with the easy-to-use icon editor built into Magic Desk. Magic Desk allows you to set up multiple levels of menu pages which can hold a virtually unlimited number of programs. You can password protect individual programs or entire menu pages. You can assign hotkeys to run particular programs or open menu pages. You also have the option of providing variable program parameters at the time you run a program. Magic Desk has a built- in screen blanker and usage log. It also allows you to use PCX files as background images. Magic Desk does not remain in memory while it is running your programs. 2 =================== SYSTEM REQUIREMENTS =================== - MS-DOS 3.0 or later - EGA/VGA - 512K RAM - Hard Disk - Microsoft-compatible Mouse (optional) ===================== INSTALLING MAGIC DESK ===================== Magic Desk is distributed in a compressed format and cannot be run directly as is. You must first install it on your hard drive. To install it: 1. When you see the C> prompt (or a similar prompt that identifies your hard drive), insert the program disk in disk drive A (or B). 2. Type A:INSTALL (or B:INSTALL) and press the ENTER key. 3. Follow the instructions on the screen. =================== STARTING MAGIC DESK =================== To start Magic Desk at the DOS prompt, type MAGIC then press ENTER. Magic Desk automatically detects whether your system has an EGA or VGA compatible graphics card and switches to the highest graphics mode available. It will also detect the presence of a mouse if you have a Microsoft-compatible mouse driver installed. If you have display problems, such as part of the main Magic Desk page not being visible, or the mouse pointer not displaying, Magic Desk may not be correctly detecting the video mode. You can try to force Magic Desk into the correct graphics mode by typing "MAGIC E" for EGA or "MAGIC V" for VGA. If the mouse pointer still doesn't display, check to ensure you have a mouse driver properly installed. If you would like Magic Desk to run automatically when you turn on your computer, you can include the appropriate commands in your AUTOEXEC.BAT file. See the "Tips and Techniques" section of this User's Guide for complete details. 3 =========================== MOVING AROUND IN MAGIC DESK =========================== When you open a window, such as the Helper window described later, it pops up on top of the current page and any windows that may already be displayed. The top window is always the active window. You can only access objects (normally buttons and text boxes) that are in the active window. SELECTING OBJECTS - MOUSE Move the mouse pointer to the desired object in the active window and click any of the mouse buttons once. In Magic Desk all mouse buttons have the same effect, and no double clicks are required. SELECTING OBJECTS - KEYBOARD 1) ALT Key: Objects can be selected by pressing the ALT key plus a letter key. Most objects have one or more words under them or to the right of them describing the function of the button or box. One of the letters in the words will have an underscore beneath it. To select the object, hold down the ALT key and press the letter that is underscored. For example, at the Helper window, to select the Remove Program or Page button, hold down the ALT key and press "R". Some buttons don't have text descriptions. The keys to select these buttons are: - STOP Button: ALT+S (only at title page) - Painter Button: ALT+P (only at title page) - Information Button: ALT+I (only at title page ) - Close Window Button: ESC - Helper Button: ALT+H - OK Button: ALT+O - Arrange Icons: ALT+A - Up-Arrow Button: Page Up - Down-Arrow Button: Page Down 2) Outline Cursor: In some windows you must use the arrow keys on your keyboard to move from one object to the next. An outline cursor will indicate the current object. To select the current object, press the ENTER key. (If you have a mouse, this outline cursor can be turned off if you intend to use only the mouse to select objects. See "Setting Configuration Options" below for instructions.) 4 EDITING TEXT In using Magic Desk, you will sometimes need to enter information in text boxes. This section describes the general procedures for entering and editing text in text boxes. 1) Positioning the Text Cursor (Mouse): Move the mouse pointer directly to the desired location within any of the text boxes in the active window and click one of the mouse buttons. The text cursor (a thin black vertical line) will move to the mouse pointer position. 2) Positioning the Text Cursor (Keyboard): Select the desired text box using the ALT key combinations, TAB/SHIFT-TAB, or up and down arrow keys as described above. Move around within the text box by using the left and right arrow keys. Pressing the TAB key or ENTER key will move the text cursor to the next text box. Pressing the TAB key while holding down SHIFT key will move the text cursor to the previous text box. 3) Entering Text: After positioning the text cursor, begin typing. The text will be inserted at the text cursor location. Magic Desk will not allow you to enter more text than will fit inside the text box. 4) Deleting Text: To delete a character to the right of the text cursor, press the DELETE key. To delete a character to the left of the text cursor, press the BACKSPACE key. CLOSING THE ACTIVE WINDOW OR PAGE The button in the upper left corner of the window or page is always used to close the window and return to the previous window or page. Select this button with the mouse or press the ESCAPE key. If you have made changes to information in a window, be sure to save the changes before closing the window. SAVING CHANGES After you have made changes, such as adding a new program or changing the configuration, you must save these changes to disk. Do this by selecting the OK button with the mouse or typing ALT+O. If you decide you don't want the changes to be made, simply close the window without saving them. 5 MOVING BETWEEN PAGES Icon buttons can represent either programs or pages, depending on how you have them set up (see "Adding a Program or Page" below). Program buttons start a program when selected; page buttons open a new page when selected. Pages can be be nested five deep. To close the current page and return to the previous page, select the button in the upper left corner of the page or press the ESCAPE key. USING FILE PICKLISTS Magic Desk makes it easy for you to enter file information for programs, icons, etc., by displaying file picklists. Instead of having to remember and type in the exact drive, directory and filename for various files, you just have to locate the file in the picklist and select it with the mouse or keyboard. 1) Available drives are indicated in the picklist with a letter followed by a colon (":"). Selecting a drive from the picklist will cause the files in the current directory on that drive to be displayed. b. Subdirectories of the current directory are indicated in the picklist by a backslash ("\") at the end of the name. Selecting a subdirectory will cause the files for that directory to be displayed. Selecting the "..\" entry will display the files of the parent directory of whatever directory you are currently in. c. Selecting a file from the picklist will close the picklist window and automatically fill in the appropriate text box or boxes with the file information. If the file list contains more than 16 drives, directories and files, select the blue arrow buttons (or press the Page Up and Page Down keys) to display the next or previous 16 files. Magic Desk will only display the first 1024 file names in any directory. ======================== ADDING A PROGRAM OR PAGE ======================== Open the Helper window by selecting the Helper button (the red cross) or by typing ALT+H. Select the Add Program or Page button. This will open a window containing the following objects: 1) Program Files Button: Select this button to open a file picklist of all program (COM, EXE, and BAT) files. Selecting a file from this picklist will automatically fill in the Path and Program text boxes (see 8 and 9 below). 6 2) Icon Files Button: Select this button to open a file picklist of all Magic Desk icon (ICN) files. Selecting a file from this picklist will automatically fill in the Icon text box (see 10 below) and display the icon in the box at the bottom of the window. 3) Copy Button: Select this button to copy all information currently in the Add Program or Page window to a temporary storage area in memory or "clipboard". This information can later be pasted into another program or page button being added or modified. (NOTE: Copying the information for a page button also causes the information about all the program buttons on that page to be copied. Magic Desk will not let you copy the information for a page button if the page represented by the button contains page buttons itself (i.e. if the page contains subpages)). The copied information remains in the clipboard until you: (1) overwrite it by using the Copy button again; (2) run an application; or (3) exit Magic Desk. 4) Paste Button: Select this button to paste program or page information, previously copied to the clipboard with the Copy button, to the current window. This is useful if you want to duplicate the same program button on more than one page or copy the contents of a page to a new page. 5) Button Title Text Box: Enter a title for the program or page button. This will be the title that will appear under the button. If you are entering information for a page button, this will also be the title at the top of the page when it is opened. 6) Password Text Box: You can enter an optional password that a user must enter to start the program or open the page. Passwords are always displayed on the screen as a series of asterisks. This prevents someone looking over your shoulder from viewing the password on the screen. If you forget the password there is no way to look it up. You will have to enter a new password. 7) Key Text Box: You can enter an optional hotkey to be used to select the program or page. You can use any printable character as a hotkey. Upper and lower case letters are treated as the same letter. Ensure that no two program/page buttons on the same page have the same hotkey, or Magic Desk will always select the first one it finds. These are not ALT key combinations. If you enter "M" as the hot key to run a "Mickey Mouse" program, you will just press the "M" key to run the program, not ALT+M. 8) Path Text Box: Enter the drive/directory of the program. The easiest way to do this is to use the Program Files button, which will automatically fill in the correct information for both 7 Path and Program text boxes. Drive information is optional if the file is on the same drive as Magic Desk. Directory information is optional if the file is in the same directory as Magic Desk or one of the directories listed in the DOS PATH statement. The directory must begin with a backslash ("\"). Example: C:\NATHAN\GAMES\ 9) Program Text Box: Enter the command to execute the program, plus any optional parameters. Example: MICKABC /E 10) Icon Text Box: Enter the complete path and filename of the icon to be displayed on the button. The easiest way to do this is to use the Icon Files button described above, which will automatically fill in the correct information. Drive information is optional if the icon file is on the same drive as Magic Desk. Directory information is optional if the icon is in the same directory as Magic Desk. The directory must begin with "\". Example: C:\ICONS\ABC.ICN Magic Desk can only use icons in Magic Desk format, normally represented by a ".ICN" extension. These icons can be designed using the Painter icon editor built into Magic Desk. A number of sample icons are included on the Magic Desk disk. For instructions on designing your own icons or importing Microsoft Windows icons, see the "Painter" section below. 11) Page Button: Icon buttons can represent either a program to be launched or a page (submenu) to be opened. Setting the Page button to "YES" indicates that information being entered is for a button that will be used to open a page. In this case, anything entered in the Program and Path text boxes is ignored. Magic Desk allows up to five nested levels of pages. 12) Batch File Button: Set this to "YES" if the program is a batch file (a file with a ".BAT" extension), otherwise the program will not return to Magic Desk after it runs. Another option for running a batch file (and actually the preferable option) if you are using MS-DOS 3.3 or later, is to leave this set to "NO" and precede the program name with the word "CALL" in the "Program" text box. Example: CALL PRODIGY.BAT 13) Wait Button: Setting this to "YES" causes Magic Desk to wait for ENTER to be pressed before returning to Magic Desk after running the program. This is useful if you need time to view the results of the program before Magic Desk reappears. 8 14) Variables Button: Setting this to "YES" allows you to enter additional command line parameters at the time you run the program. This is useful if you sometimes run the same program with different parameters. 15) OK Button: After you have entered all necessary information, select the OK button with the mouse or press ALT+O to save the information to disk and close the window. To close the window without adding the program/page, select the Close Window button in the upper left corner of the window or press the ESCAPE key. ========================== REMOVING A PROGRAM OR PAGE ========================== Open the Helper window by selecting the Helper button (the red cross) or by pressing ALT+H. Select the Remove Program or Page button. This will open a window listing the names of all the program/page buttons on the current page. Select all of the program/page buttons you wish to remove, then select the OK button or press ALT+O. To close the window without removing any programs, select the Close Window button with the mouse or press the ESCAPE key. Removing a program button from Magic Desk does not delete the program from disk. It still exists and can be run normally from DOS or later added back to Magic Desk. After removing a program/page button, you may want to rearrange the remaining buttons (see "Arranging Buttons" below ). If you remove a button representing a page, all the program buttons belonging to that page are also removed. Magic Desk will allow you to remove a button representing a page that contains program buttons, but it will not allow you to remove a page button that itself contains more subpages. If you try to remove a page button that has subpages, you will get a message saying "Pages containing subpages were not removed." To remove the button in a case like this, you must first close the Helper window, open the page containing the subpages, and remove all the subpages individually. =================================== VIEWING/MODIFYING A PROGRAM OR PAGE =================================== Open the Helper window by selecting the Helper button (the red cross) or by pressing ALT+H. Select the View/Modify Program or 9 Page button. This will open a window listing the names of all the program and page buttons on the current page. Select the program/page button you wish to view or modify. A window will open containing the current information for that program/page button. You can make any desired changes using the same techniques used in the Add Program or Page window. ============================= SETTING CONFIGURATION OPTIONS ============================= All pages have a Helper window which is used to add, remove or view/modify buttons on that page. The Helper window for the main title page contains extra buttons for customizing how Magic Desk looks and works. Selecting the Configuration Options button opens a window in which you set the following options. 1) Arrange Icons: Setting this to "NO" prevents a user from rearranging the buttons on any page (see "Arranging Buttons"). 2) STOP Button: Setting this to "NO" prevents a user from exiting Magic Desk by disabling the STOP button on the main title page. To exit the program when the STOP button is disabled, a user must press ALT+S. As an additional level of security, you can password protect the ALT+S function (see "Password" below). 3) Helper Button: Setting this to "NO" prevents a user from changing any page/program or configuration information by disabling the Helper button (the red cross) on all pages. To open the Helper window when the Helper button is disabled, a user must press ALT+H. As an additional level of security, you can password protect the ALT+H function (see "Password" below). 4) Disk Access: Setting this to "NO" disables the Read Icon and Write Icon buttons in Painter. To access the Read Icon button when disk access is disabled, a user must press ALT+R. To access the Write Icon button when disk access is disabled, a user must press ALT+W. As an additional level of security, you can password protect the ALT+R and ALT+W functions (see "Password" below). 5) Usage Log: Setting this to "NO" turns off the usage log. When the Usage Log button is set to "YES", each time you run a program from Magic Desk, information is recorded in a file called USAGE.LOG. The log records the program title, the date and time the program was launched, and the elapsed time. The log is in standard ASCII text format, so you can view and/or print it from any text editor or word processor. 6) Cursor: Setting this to "NO" turns off the outline cursor used to indicate the current object on pages. If you do 10 not have a mouse installed you should leave this set to "YES". If you have a mouse installed, and you use only the mouse to select objects, you can turn the cursor off if you find it distracting. 7) Main Title: Enter a title up to 24 characters long that will appear on the main title page. 8) Password: You can enter an optional password that will be required in three situations: (1) when a user attempts to exit the program with ALT+S; (2) when a user attempts to open the Helper Window with ALT+H; or (3) when a user attempts to read or write a disk file in Painter with ALT+R or ALT+W. The same password applies to all three situations. This password has no effect on individual programs or pages. Passwords for these are set in the Add Program or Page or the View/Modify Program or Page windows. 9) PCX File: Enter the complete path and filename of the PCX file to be displayed as a background on the opening title page. The easiest way to do this is to use the PCX Files button described above, which will automatically fill in the correct information. Drive information is optional if the icon file is on the same drive as Magic Desk. Directory information is optional if the icon is in the same directory as Magic Desk. The directory must begin with "\". Example: C:\PCXFILES\CHESS.PCX If the entire image will fit on the screen, Magic Desk will center it vertically and horizontally. If the image is larger than the screen, Magic Desk will display as much of the image as possible, beginning with the upper left corner of the image. Magic Desk can only display 16-color PCX Files. Many PCX files do not use a standard color palette, which will cause unpredictable colors when displayed in Magic Desk. If you have access to a system with Microsoft Windows you can use the Paintbrush accessory that comes with Windows to change the palette to the one used by Magic Desk and Windows. Open Paintbrush and perform the following steps: a. Open the PCX file. b. Save it as a PCX file with a different name. Paintbrush will save the new file in the default palette. After the conversion, the colors in the image may not be exactly the same as the original, but they will be very close. You can then use the new PCX file in Magic Desk. 10) OK Button: After you have set the options the way you want them, select the OK button with the mouse or press ALT+O. 11 This will save the current settings to disk and close the Configuration Options window. No changes take effect until they are saved to disk. To close the window without saving any changes, select the small red Close Window button with the mouse or press the ESCAPE key. ===================== SETTING COLOR OPTIONS ===================== All pages have a Helper window which is used to add, remove or view/modify buttons on that page. The Helper window for the main Magic Desk title page contains extra buttons for customizing how Magic Desk looks and works. Selecting the Color Options button opens a window in which you can customize the Magic Desk colors. The Color Options window contains six buttons which allow you change the colors of the background, title bar, title, text, text box, and outline cursor. The window also displays a miniature representation of the screen, so you can see the results immediately. To change the colors, select the appropriate button until the desired color appears. Magic Desk will cycle through 16 colors and then start over again. NOTE: The outline cursor color will vary according to the color of the background, so you should select the cursor color AFTER selecting the background color. The cursor color will also be affected if you have a multicolor PCX image displayed in the background on the main page. Again, the cursor color will vary according to what is behind it. After you have set the options the way you want them, select the OK button with the mouse or press ALT+O. This will save the current settings to disk and close the Helper window. No changes take effect until they are saved to disk. To close the Helper window without saving any changes, select the small red Close Window button with the mouse or press the ESCAPE key. ============================== SETTING SCREEN BLANKER OPTIONS ============================== All pages have a Helper window which is used to add, remove or view/modify buttons on that page. The Helper window for the main Magic Desk title page contains extra buttons for customizing how Magic Desk looks and works. Selecting the Screen Bkanker Options button opens a window in which you can customize the the built-in screen blanker. 12 The screen blanker built into Magic Desk can be used to blank the monitor screen after a specified period of keyboard and/or mouse inactivity. If you often leave your computer on for extended periods of time, this can lengthen the life of your monitor. To unblank the screen, simply press the space bar or move the mouse. The screen will instantly reappear exactly as you left it. In the Screen Blanker Options window you can set the following options: 1) Blanker: Set this button to YES to enable the screen blanker. 2) Mouse: If you have a mouse installed on your system, set this button to YES. This will cause the screen saver to recognize mouse movements, as well as keystrokes, and not blank the screen as long as it detects either. 3) Timer: Enter a number between 0 and 59. This number determines the number of minutes after which the screen saver will blank the screen if it has not detected any keyboard or mouse activity. If you enter a number less than zero, Magic Desk will convert it to zero, which effectively disables the screen saver. The screen will never blank as long as Timer is set to zero. If you enter a number greater than 59, Magic Desk will convert it to 59. If you enter characters other than a valid number, Magic Desk will convert it to zero. 4) OK Button: After you have set the options the way you want them, select the OK button with the mouse or press ALT+O. This will save the current settings to disk and close the Screen Blanker Options window. No changes take effect until they are saved to disk. To close the window without saving any changes, select the small red Close Window button with the mouse or press the ESCAPE key. ================================ RUNNING PROGRAMS FROM MAGIC DESK ================================ After you have added a program button to Magic Desk, you can easily run the program by: (1) selecting the program button with the mouse; (2) selecting it with the arrow keys and pressing ENTER (if the cursor is enabled); or (3) pressing the hot key associated with the program. If you have entered the path and program information correctly, the program will start normally as it would from the DOS command line. When you exit the program, Magic Desk will reappear. 13 If the program does not run correctly, use the View/Modify Program or Page window to change the program information. If the program is a batch file and runs correctly, but does not return to Magic Desk after running, ensure you have the Batch button set to "YES". ================= ARRANGING BUTTONS ================= As you add program/page buttons to Magic Desk, they are displayed in rows of five, starting in the upper left position on the page. You can rearrange the buttons in any order. Before arranging the buttons, you must set the Arrange Icons button in the Configuration Options window to YES. After you are finished arranging the buttons, you may want to reset the Arrange Icons button to NO. MOVING BUTTONS - MOUSE To move an icon button to a new location on the screen, position the mouse pointer anywhere on the icon button and press one of the mouse buttons. While still holding down the mouse button, move the mouse pointer to the location where you want the icon button to be. As you move the mouse, an outline of the icon button will move with it. After you have positioned the outline of the icon button where you want it, release the mouse button. The page will redraw with the icon button in the new location. (NOTE: There is small delay after holding the mouse button down before the button outline begins to move.) MOVING BUTTONS - KEYBOARD To move an icon button to a new location on the screen, first position the outline cursor on the button, using the arrow keys or the TAB/SHIFT-TAB keys. To move the button hold down the CTRL key as you press the left arrow, right arrow, Page Up, and Page Down keys. (NOTE: There are technical considerations with the IBM PC keyboard which force us to use CTRL-Page Up and CTRL-Page Down instead of CTRL-Up Arrow and CTRL-Down Arrow.) As you press these keys, the new position of the icon button will be indicated by an outline of the button. After you have positioned the outline of the icon button where you want it, press the ENTER key. The page will redraw with the icon button in the new location. IMPORTANT NOTE: Pressing the ENTER key after moving an icon button with the CTRL key combinations indicates to Magic Desk that you have finished moving the button. No other keys will work 14 until you press the ENTER key. Also, if you have a mouse installed, but choose to move an icon button with the CTRL key combinations, do not click any of the mouse buttons before you press the ENTER key. Doing so will cause unpredictable results. CHANGING THE ORDER If you choose, you can move the icon buttons to any position on the page and leave them there. Although they may be in different positions, Magic Desk still considers them to be in the same order they were originally in. Therefore, using the arrow keys and TAB key to move the red cursor between objects may give you some unexpected results. If you use the mouse to select icon buttons, this will not be a problem. To change the actual order of the icon buttons and line them back up in evenly spaced rows of five, move the buttons to the approximate position you want them to be in, then press ALT+A. The page will redraw with the icon buttons lined up evenly spaced in the new order. ======= PAINTER ======= Painter is an icon editor built into Magic Desk. With Painter you can design your own 32x32 pixels, 16 color icons for programs you install in Magic Desk, or you can import Microsoft Windows icons and convert them to Magic Desk format. PAINTING ICONS - MOUSE Choose a color by selecting any of the 16 palette buttons with the mouse. The current color will always show in the box above the palette buttons. After selecting a color, position the mouse pointer in the desired square on the large icon grid box, then press any mouse button. The square will change to the current color. To paint multiple squares with the same color, hold one of the mouse buttons down while dragging the mouse pointer over the squares you want to paint. As you paint the icon on the large grid box, you will also see the effects displayed on the actual- size button to the right of the large grid box. 15 PAINTING ICONS - KEYBOARD Choose a color by moving the red outline cursor to the desired palette button with the arrow keys, then press the ENTER key. The current color will always show in the box above the palette buttons. After selecting a color, press the SPACEBAR. This will cause a small yellow grid cursor to appear in the large icon grid box. Move the grid cursor to the desired square using the arrow keys, then press the ENTER key. The square will change to the current color. When you are ready to select a new color, press the SPACEBAR again. The red outline cursor will appear again in the palette buttons. To paint multiple squares with the same color, hold down the CTRL key as you press the left arrow, right arrow, Page Up, and Page Down keys. The squares will be painted as the grid cursor moves over them. (NOTE: There are technical considerations with the IBM PC keyboard which force us to use CTRL-Page Up and CTRL-Page Down instead of CTRL-Up Arrow and CTRL-Down Arrow. We realize it's more awkward than it should be.) FILL ALL BUTTON Select this button to fill the entire grid with the current color. READ ICON BUTTON Select this button to read in an already-existing icon from disk. Selecting this button will cause a window with a text box to pop up. Enter the path and file name of the icon file in the text box. Example: C:\ICONS\ABC.ICN The easiest way to do this is to select the Icon Files button, which will allow you to choose from a picklist of Magic Desk and Windows icon files (ICN and ICO). Drive information is optional if the icon file is the on same drive as Magic Desk. Directory information is optional if the icon file is in the same directory as Magic Desk. The directory must begin with "\". If you don't put an extension on the file name, Painter will assume a ".ICN" extension. After you have entered the icon file information, press the ENTER key or select the OK button to read the icon file. The icon will be displayed on the large icon grid box and the actual-size button to the right. To close the window without reading an icon, select the red Close Window button. 16 WRITE ICON BUTTON Select this button to save the displayed icon to a disk file. Use the same procedures as described in the previous paragraph. IMPORTING MICROSOFT WINDOWS ICON FILES To import a Microsoft Windows icon file (normally with a ".ICO" extension), read it in like you would a normal Magic Desk icon. Painter will make the conversion as it reads the file in. After you have made any desired changes to the icon, write it to disk. If you use the same file name, do not use the ".ICO" extension or you will write over the Windows version of the icon file. If you don't specify an extension, Painter will attach a ".ICN" extension. Painter can only import MS Windows icons that are in 32x32x16 format (32 pixels by 32 pixels by 16 colors). The vast majority of MS Windows icon files available are in this format. If you are using a Windows program you may not be able to find any icon files. Most MS Windows programs do not have separate icon files. Instead, the icons are stored in one of the program files (".EXE" or ".DLL"). A single MS Windows program file can have several icons stored in it. Painter cannot extract the icons from these files, but there are several utility programs available that can extract the icons and put them into separate icon files that Painter can import. =================== TIPS AND TECHNIQUES =================== RUNNING MULTIPLE COMMANDS Magic Desk allows you to directly run one program or DOS command per program button. If you need to run a series of programs or commands, you can do this by creating a batch file containing all the necessary commands and setting up a program button to run the batch file. To easily create batch files you can set up a program button to open your favorite text editor or word processor. The text editor that is included with MS-DOS 5.0 provides a quick, easy way to create, view and edit batch files and other text files. Here is a sample setup for a program button to run the DOS editor from Magic Desk: 17 Button Title: MS-DOS Editor Page: NO Password: (your choice) Batch File: NO Key: E Variables: YES * Path: C:\DOS\ WAIT: NO Program: EDIT Icon: C:\MDESK\EDIT.ICN * Setting Variables to "YES" will allow you to specify the file to edit as a command-line parameter at the time you run the editor. FILE MANAGER Magic Desk does not include built-in file management features, but you can easily set up a program button to access your favorite file management program. The DOS Shell included with MS-DOS 5.0 provides a graphical file manager for copying, deleting and moving files and directories. Here is a sample setup for a program button to run the DOS Shell program from Magic Desk: Button Title: MS-DOS Shell Page: NO Password: (your choice) Batch File: NO Key: S Variables: NO Path: C:\DOS\ Wait: NO Program: DOSSHELL Icon: C:\MDESK\SHELL.ICN DOS COMMAND LINE In some cases you may find that you need to execute a program or DOS command from the DOS command line. You have two choices. The first choice is to exit from Magic Desk, execute the command and, when you're finished, start Magic Desk again. A better solution, particularly if you will need to do this on a recurring basis, is to set up a program button to put you at the DOS command line temporarily without exiting Magic Desk. This is done by using the COMMAND function of DOS. The following sample program button, when selected, will display the DOS prompt. You can run any programs/commands as you normally would from the command line. To return to Magic Desk, type EXIT at the command line and the current Magic Desk page will reappear. Button Title: MS-DOS Prompt Page: NO Password: (your choice) Batch File: NO Key: S Variables: NO Path: C:\DOS\ Wait: NO Program: COMMAND Icon: C:\MDESK\DOS.ICN 18 MICROSOFT WINDOWS PROGRAMS If you have a combination of DOS and Windows programs, you may find it convenient to run Windows as a program under Magic Desk. Since Magic Desk loads much faster than Windows, you won't have to wait for Windows to load before you access your DOS programs. You can set up a program button to open Windows as follows: Button Title: Microsoft Windows Page: NO Password: (your choice) Batch File: NO Key: W Variables: NO Path: C:\WINDOWS\ Wait: NO Program: WIN Icon: C:\MDESK\WIN.ICN Another technique is to set up a page called "Windows Programs" and create separate program buttons for each of your Windows applications. To automatically load Windows and run a specific Windows application, enter the Path and Program information as you would for a normal DOS application, then precede the program name with "WIN". Here is a sample program button set up to load Windows and run Quicken for Windows: Button Title: Quicken Page: NO Password: (your choice) Batch File: NO Key: W Variables: NO Path: C:\QUICKENW\ Wait: NO Program: WIN QW.EXE Icon: C:\MDESK\QUICKEN.ICN MODIFYING YOUR AUTOEXEC.BAT FILE You may want to add the necessary commands to your AUTOEXEC.BAT file to run Magic Desk automatically when the computer is turned on. If you aren't familiar with the purpose and contents of your AUTOEXEC.BAT file, you may want to have someone assist you. Assuming the Magic Desk program files are on the C drive in the \MDESK directory, you would add the following commands at the end of your AUTOEXEC.BAT file (if the files are on a different drive or directory, substitute the correct information): C: CD \MDESK MAGIC 19 =================================== COMPATIBILITY WITH EARLIER VERSIONS =================================== The configuration files for this version of Magic Desk are not compatible with earlier versions of ToyBox. Icon files from earlier versions of ToyBox are compatible, except the colors will probably not be correct. You can read the icons into Painter one at time and correct the colors. The registered version of Magic Desk includes a utility that will correct the colors of all old icons in a specified directory in a single pass. Magic Desk and ToyBox are trademarks of Virtual Magic Software. Windows is a trademark of Microsoft Corporation. MS-DOS is a registered trademark of Microsoft Corporation. Quicken is a registered trademark of Intuit. 20